home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / programming / aros / readme.compat < prev    next >
Text File  |  1996-09-13  |  2KB  |  43 lines
  1. WHAT IS THIS
  2. ------------
  3.  
  4. This file is a collection of things which are different between AROS and the
  5. original AmigaOS and how they are handled in order to be compatible.
  6.  
  7. DIFFERENCES BETWEEN AROS AND THE AMIGA OS
  8. -----------------------------------------
  9.  
  10. * Pointer/Integer conversions
  11.  
  12. If you need a variable which can store a pointers as an integer, don't use
  13. ULONG but IPTR. AROS gurantees that LONG is 32bit on all systems, while
  14. IPTR is always large enough to contain a pointer. Most notable things
  15. which are affected by this: TagItems (the ti_Data field is now an IPTR
  16. instead of ULONG), BOOPSI classes (eg. the return value of DoMethod()),
  17. ReadArgs(), VPrintf(), VFPrintf() and more.
  18.  
  19. * 64bit variables
  20.  
  21. The type of 64bit variables is QUAD (unsigned: UQUAD). This is for example
  22. returned by the function SMult64() of Utility.library. To access the
  23. high- and loworder 32bit values of the 64bit variable, use LOW32OF64()
  24. and HIGH32OF64() which are defined in <aros/64bit.h>.
  25.  
  26. * Cloning RastPorts
  27.  
  28. AROS uses an external driver to access the graphics hardware. Since the
  29. nature of this driver is unknown to AROS, it is no more valid to clone
  30. a RastPort by simply copying it. To be compatible, there are two new
  31. functions (in AROS) or macros (on Amiga): CloneRastPort() and FreeRastPort().
  32. You must call CloneRastPort() to create a copy and FreeRastPort() after
  33. you´ve done your work with it.
  34.  
  35. This approach produces equivalent code on the Amiga but on AROS it can slow
  36. things down a bit. If you must preserve the original state of the RastPort,
  37. it's more save to create a clone, work on it and then dispose it again. It
  38. can also be faster if you would have to make a lot of changes to the RastPort
  39. to create two clones and set them to the two states you need. But your code
  40. should not depend on certain gains or losses of speed due to cloned RastPorts
  41. since the behaviour of the underlying graphics system is undefined.
  42.  
  43.